package com.ruoyi.note.service;

import java.util.List;
import com.ruoyi.note.domain.NoteCategory;
import com.ruoyi.common.core.domain.Ztree;

/**
 * 笔记分类Service接口
 * 
 * @author ruoyi
 * @date 2025-01-22
 */
public interface INoteCategoryService 
{
    /**
     * 查询笔记分类
     * 
     * @param categoryId 笔记分类主键
     * @return 笔记分类
     */
    public NoteCategory selectNoteCategoryByCategoryId(Long categoryId);

    /**
     * 查询笔记分类列表
     * 
     * @param noteCategory 笔记分类
     * @return 笔记分类集合
     */
    public List<NoteCategory> selectNoteCategoryList(NoteCategory noteCategory);

    /**
     * 查询笔记分类树结构
     * 
     * @param noteCategory 笔记分类
     * @return 笔记分类集合
     */
    public List<NoteCategory> selectNoteCategoryTree(NoteCategory noteCategory);

    /**
     * 构建前端所需要树结构
     * 
     * @param categories 分类列表
     * @return 树结构列表
     */
    public List<NoteCategory> buildCategoryTree(List<NoteCategory> categories);

    /**
     * 构建前端所需要下拉树结构
     * 
     * @param categories 分类列表
     * @return 下拉树结构列表
     */
    public List<Ztree> initZtree(List<NoteCategory> categories);

    /**
     * 新增笔记分类
     * 
     * @param noteCategory 笔记分类
     * @return 结果
     */
    public int insertNoteCategory(NoteCategory noteCategory);

    /**
     * 修改笔记分类
     * 
     * @param noteCategory 笔记分类
     * @return 结果
     */
    public int updateNoteCategory(NoteCategory noteCategory);

    /**
     * 批量删除笔记分类
     * 
     * @param categoryIds 需要删除的笔记分类主键集合
     * @return 结果
     */
    public int deleteNoteCategoryByCategoryIds(String categoryIds);

    /**
     * 删除笔记分类信息
     * 
     * @param categoryId 笔记分类主键
     * @return 结果
     */
    public int deleteNoteCategoryByCategoryId(Long categoryId);

    /**
     * 校验分类名称是否唯一
     * 
     * @param noteCategory 分类信息
     * @return 结果
     */
    public boolean checkCategoryNameUnique(NoteCategory noteCategory);
}